Summary

Complete physical device support for iOS and Android, with HTTP fallback transport and WiFi testing mode.

Physical Device Infrastructure

• Physical iOS: launch/terminate via xcrun devicectl, token via idevicesyslog, port forwarding via managed iproxy
• Physical Android: ADB validation, device reachability check, stale port forward cleanup
• HTTP POST fallback (POST /probe/rpc): stateless transport for physical devices — each command is an independent HTTP request, no persistent connection to drop
• ProbeClient interface: both WebSocket Client and HTTPClient satisfy it, enabling transport-agnostic execution

WiFi Testing (recommended for physical iOS)

• --host <ip> flag to connect directly to device WiFi IP (no USB, no iproxy)
• --token <token> flag to skip USB-dependent token auto-detection
• --dart-define=PROBE_WIFI=true binds agent to 0.0.0.0 for network access
• Tested: 11/12 E2E tests pass over WiFi with zero connection drops (vs frequent drops over USB-C)

ProbeScript Enhancements

• tap "X" if visible syntax — silently skips when widget not found (also works with type, clear, long press, double tap)
• take screenshot "name" — no longer requires called keyword
• Direct onTap fallback for Semantics-wrapped widgets on physical devices

Connection Resilience

• WebSocket ping/pong keepalive (5s interval)
• Auto-reconnect on connection loss (up to 2 retries per step)
• EnsureIProxy() / EnsureADB() — automatic tool validation and stale process cleanup
• ProbeAgent profile mode + release mode safeguards

Physical Device Behavior

Files Changed (3 commits, 38 files, +1727 / -131)

New files:

• internal/probelink/http_client.go — HTTP POST transport
• internal/probelink/http_client_test.go — HTTP client tests
• internal/probelink/iface.go — ProbeClient interface
• internal/ios/devicectl.go — Physical iOS device ops
• Test files: cmd/probe, cli, ios, device packages

Core changes:

• probe_agent/lib/src/server.dart — HTTP POST endpoint + WiFi bind support
• probe_agent/lib/src/executor.dart — Direct onTap fallback, unique pointer IDs
• probe_agent/lib/src/finder.dart — Visibility filtering
• probe_agent/lib/src/agent.dart — Profile/release mode, PROBE_WIFI support
• internal/parser/ — if visible suffix, screenshot name fix
• internal/runner/ — ProbeClient interface, auto-reconnect, UseHTTP flag
• internal/cli/test.go — --host, --token flags, iproxy/ADB management
• internal/device/manager.go — EnsureADB, EnsureIProxy, physical detection

Test Results

• go test ./... — 115+ tests pass across all 15 packages
• Physical iPhone E2E (WiFi) — 11/12 tests pass, zero connection drops
• Physical iPhone E2E (USB) — 8/12 tests pass, auto-reconnect handles USB-C drops
• go build ./... — compiles cleanly
• iOS simulator regression
• Android emulator regression

Test plan

• Physical device WiFi: launch, navigation, login, dashboard, settings, items, gestures, visual, dynamic, device, API
• if visible syntax parsing and execution
• HTTP POST transport round-trip
• Screenshot name without called keyword

🤖 Generated with Claude Code